# Neural Network Demos Project

This project contains a modular neural network implementation and several educational demo projects for classification and regression.

## Project Structure

```
neural_network/
    (core neural network code as a package)
demos/
    __init__.py
    diabetes/
        __init__.py
        demo-diabetes.py
        diabetes-explanation.md
        diabetes_binary_5050split_health_indicators_BRFSS2015.csv.gz
    bike_share/
        __init__.py
        demo-bike-share.py
        ...
    mnist_digits/
        __init__.py
        demo-mnist-digits.py
        ...
    fashion_mnist/
        __init__.py
        demo-fashion-mnist.py
        ...
README.md
```

## How to Run a Demo

**From the project root directory**, (the folder containing the demos and neural_network folder) use the `-m` flag to run any demo as a module. For example:

```bash
python -m demos.diabetes.demo-diabetes
python -m demos.bike_share.demo-bike-share
python -m demos.mnist_digits.demo-mnist-digits
python -m demos.fashion_mnist.demo-fashion-mnist
```

This ensures all imports work cleanly and consistently.

## Notes

- Do not run demo scripts directly with `python demo-*.py` from inside their folders; always use the `-m` flag from the project root.
- Each demo folder contains its own data and documentation for clarity.